# lines with '#' are comments that are not executed

# This file contains examples of how to add additional functionality to Snak. 
# The examples respond to new CTCP requests or changes the way existing 
# requests are handled.

# To automatically load this into a connection, add "/load ctcpcatcher" to the startup actions.

# This method can add additional processing of existing CTCP functions
# Snaks existing CTCP processing will still happen

on ^ctcp "% % CLIENTINFO *" {
	echo *** $0 requests your CLIENTINFO
}


# this method can als add new CTCP selectors like PAGE. Your processing of Beeps 
# must be set on in the preferences, or the command will be silent

# Depending on your editor you may or may not be able to see that there are two "beep"
# characters before and after the text.

# the '^' in front of ctcp makes Snak stop processing of the message after the handler 
# has executed. If this was '-' or missing then Snak would try and do PAGE as well 
# but this would give an error message

on ^ctcp "% % PAGE" {
	echo *** --------------------------------------
	echo *** * CTCP PAGE received from $[10]0 *
	echo *** --------------------------------------
}


# the raw_irc method a way to be the very first that accesses incoming data
# it is only way that can block the existing processing of CTCP requests by swallowing 
# the data before any other parts of Snak acts on it

# This script uses the $nickonly function from the Basical script file.
# The function splits the nick!userhost string and returns the nick.

# Input:
# $0 : nick!userhost

^on ^raw_irc "% PRIVMSG % :*
*VERSION*
*" {
	echo *** $0 requested your client version
	quote NOTICE $nickonly($0) :
VERSION A really good IRC client

}

# emits three beeps. Can be added to a script snippet so you can hear that it executed
# Depending on your editor you may or may not be able to see that there are three "beep"
# characters before the text.
alias beeper {
	echo  something happened
}